/**
 * @filename:Contract3Service 2024-01-01 00:00:00
 * @project com/lwl/blue  V1.0
 * Copyright(c) 2024 <a href=mailto:lanwenliang@yidianlife.com>蓝文良</a> Co. Ltd.
 * All right reserved.
 */
package com.lwl.blue.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.lwl.blue.commont.base.JsonResult;
import com.lwl.blue.commont.base.PageParam;
import com.lwl.blue.entity.Contract3;
import com.lwl.blue.entity.ContractDetail3;

import javax.servlet.http.HttpServletResponse;
import java.math.BigDecimal;
import java.util.List;

/**
 * <p>自定义service写在这里</p>
 * 
 * <p>说明： 采购合同主表服务层</P>
 * @version: V1.0
 * @author: <a href=mailto:lanwenliang@yidianlife.com>蓝文良</a>
 * 
 */
public interface Contract3Service extends IService<Contract3> {
    
    /**
     * 分页查询采购合同
     * @param pageParam 分页参数
     * @return 分页结果
     */
    JsonResult<Page<Contract3>> pages(PageParam<Contract3> pageParam);
    
    /**
     * 根据合同内码查询合同详情（包含供应商信息）
     * @param contractInnerId 合同内码
     * @return 合同详情
     */
    JsonResult<Contract3> getContractWithSupplier(String contractInnerId);
    
    /**
     * 根据关联订单号查询合同列表
     * @param relatedOrderNo 关联订单号
     * @return 合同列表
     */
    JsonResult<List<Contract3>> getContractsByRelatedOrderNo(String relatedOrderNo);
    
    /**
     * 根据合同号模糊查询合同
     * @param contractNo 合同号
     * @return 合同列表
     */
    JsonResult<List<Contract3>> getContractsByContractNoLike(String contractNo);
    
    /**
     * 统计执行中合同的总金额
     * @param contractStatus 合同状态
     * @return 总金额
     */
    JsonResult<BigDecimal> getTotalAmountByStatus(Integer contractStatus);
    
    /**
     * 根据合同内码查询合同明细列表
     * @param contractInnerId 合同内码
     * @return 合同明细列表
     */
    JsonResult<List<ContractDetail3>> getContractDetails(String contractInnerId);
    
    /**
     * 根据合同内码查询合同明细（包含产品信息）
     * @param contractInnerId 合同内码
     * @return 合同明细列表
     */
    JsonResult<List<ContractDetail3>> getContractDetailsWithItem(String contractInnerId);
    
    /**
     * 生成采购合同（从订单数据生成）
     * @param relatedOrderNo 关联订单号
     * @return 生成的合同信息
     */
    JsonResult<Contract3> generateContractFromOrder(String relatedOrderNo);
    
    /**
     * 更新合同状态
     * @param contractInnerId 合同内码
     * @param contractStatus 新状态
     * @return 更新结果
     */
    JsonResult<Boolean> updateContractStatus(String contractInnerId, Integer contractStatus);
    
    /**
     * 导出合同模板
     * @param contractInnerId 合同内码
     * @param response HTTP响应
     */
    void exportContractTemplate(String contractInnerId, HttpServletResponse response);
}
